home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor2 / inb.doc < prev    next >
Internet Message Format  |  1995-03-31  |  5KB
  1. From: phk@data.fls.dk (Poul-Henning Kamp) 
  2. Newsgroups: comp.sources.hp48 
  3. Subject: NoteBook program v0.02j 
  4. Date: 29 Aug 91 01:59:13 GMT 
  5.  
  6. This is the second (and a half) version distributed of this little gadget. 
  7.  
  8.     *** iNB -- information NoteBook 0.02j *** 
  9.  
  10. It is a small, more or less reliable "rolodex" for your HP48. 
  11. It allows you to maintain small register like a telephone list in a 
  12. convenient way on your HP48.  I call these registers "notebooks" 
  13.  
  14. In many ways this is similar to DB48, except for the speed. iNB is fast. 
  15. Indeed DB48 has been a major source of inspiration for me. 
  16.  
  17. This is not the final version (when did you last see a final version ?) 
  18. but it seems worthvile to post it at this time anyway. 
  19.  
  20. The library has lib# 1031, and will not auto-attach on cold-start; you have 
  21. to attach it manually using 
  22.    1031 ATTACH 
  23. in the directory of your choice.  The reason for not auto-attaching is that 
  24. the only sensible thing to do is to include iNBmenu in your CST or similar 
  25. menu, and thus the library need only be attached when you edit your menu, 
  26. or when you edit iNBPAR and use iNBmmdd or iNByymmdd. 
  27.  
  28. The library defines only three named objects:  
  29.  
  30.     iNBmenu         
  31.         The main thing. Puts up the menu contaning the available 
  32.         notebooks. 
  33.  
  34.     iNBmmdd 
  35.         returns todays date as a string "mmdd" ("0823") 
  36.  
  37.     iNByymmdd 
  38.         returns todays date as a string "yymmdd" ("910823") 
  39.          
  40. When you execute iNBmenu, it will read a variable named iNBPAR in HOME, 
  41. (and only in HOME !), and use the information therein to present a menu. In 
  42. the menu you can enter a particular notebook by pressing the relevant key 
  43. [blue]+key enters in find-mode and [orange]+key in add-mode., 
  44.  
  45. This is my iNBPAR: 
  46. ------------------------------------------------------------------------------- 
  47. %%HP: T(1)A(D)F(.); 
  48. {  
  49.   { 
  50.     "PHONE"                     @ Menu-label 
  51.                         @ could be a 21x8 grob... 
  52.     { 
  53.       "Telephone directory"            @ title 
  54.       { HOME BASE PHONE.NB }             @ Location 
  55.       { "f1" "f2" "f3" "f4" "f5" "f6" "f7" }     @ Fieldnames 
  56.     }  
  57.   }  
  58.   { 
  59.     "CAL"  
  60.     {  
  61.       "Calendar" 
  62.       { HOME BASE CALENDAR.DB } 
  63.       { "f1" "f2" }  
  64.       iNByymmdd                    @ Default Search string 
  65.     } 
  66.   }  
  67.   {  
  68.     "DAYS"  
  69.     {  
  70.       "Aniversaries" 
  71.       { HOME BASE DAYS.NB } 
  72.       { "f1" }  
  73.       iNBmmdd 
  74.     } 
  75.   } 
  76. } 
  77. ------------------------------------------------------------------------------- 
  78.  
  79. The location can be: 
  80.     Global-name:        name of notebook in hidden directory. 
  81.       ex:            PHONE.NB 
  82.  
  83.     list:            path of notebook. 
  84.       ex:             { HOME BASE PHONE.NB } 
  85.  
  86.     port:            port-name of notebook. 
  87.       ex:             :0:PHONE.NB 
  88.  
  89. If unable to RCL the variable, an empty list is substituted, if unable to STO 
  90. back it bails out.  (I plan to employ a panic-save variable) 
  91.  
  92. The notebook itself is a [list of list of string]. 
  93.  
  94. The first field is the "key" used for "find", and the notebook is sorted 
  95. by this field. 
  96.  
  97. Key Bindings: 
  98. ------------- 
  99.     Review    status of this notebook 
  100.     On        exit 
  101.     [left]    prev record 
  102.     [right]    next record 
  103.     [up]    scroll up 
  104.     [down]    scroll up 
  105.     a-ON    copyleft notice 
  106.  
  107. Misc Notes: 
  108. ----------- 
  109.     It is important that all records have the same number of fields, and 
  110.     that this count matches the fieldnames of the iNBPAR. 
  111.  
  112. Known bugs: 
  113. ----------- 
  114.     will happily scroll below the text of a record. 
  115.  
  116.     very few checks for consistency, be carefull with imported data. 
  117.  
  118.     does not entirely conform to the official published list of internals. 
  119.  
  120. Features planned: 
  121. ----------------- 
  122.     * Rewrite to use RPLCOMP + SASM &c &c 
  123.  
  124.     * Change to use POL. 
  125.  
  126.     * Custom display-procedure 
  127.  
  128.     * Custom validation of data 
  129.  
  130.     * Custom menus and keybindings. 
  131.  
  132.     * Custom messages in any language you like. 
  133.  
  134. Source: 
  135. ------- 
  136.     Available from the author using mail.  Presently for saturn assembler. 
  137.  
  138. Author: 
  139. ------- 
  140.     Send comments, suggestions &c &c to: 
  141.  
  142.             phk@data.fls.dk 
  143.             Poul-Henning Kamp 
  144.             FLS Data 
  145.  
  146.  
  147.                     Enjoy, 
  148.                     Poul-Henning  
  149.  
  150. --  
  151. phk@data.fls.dk           ||  A host is a host from coast to coast, 
  152. Poul-Henning Kamp         ||  & no one will talk to a host that's close, 
  153. FLS DATA A/S              ||  Unless the host (that isn't close) 
  154. Phone: (+45) 36 18 12 35  ||  is busy, hung or dead. 
  155. Fax:   (+45) 36 18 12 18  ||                 Anon (?)  
  156.